.. _ecNet_SetAlState:

ecNet_SetAlState
================
----------------

.. Hint::
   :ref:`Fast Function(_FF)  <ECAT_Appendix_00>`  사용 가능

SYNOPSYS
`````````````
.. code-block:: none

  t_cmdidx ecNet_SetAlState(
    t_i32 NetID, 
    t_ui8 AlState, 
    t_i32 *ErrCode)



DESCRIPTION
`````````````  

- 마스터의 AL-STATE 를 설정합니다. AL-STATE 는 EtherCAT 통신에서 EtherCAT Machine State를 의미합니다. 
  
- 이 Machine State에는 아래 매개변수 표와 같은 상태들이 있는데 각 상태는 의미하는 바가 다르고 통신 상태도 각각 다릅니다. (아래 링크 참조)
  
- 마스터의 AL-STATE가 바뀌면 마스터는 연결된 모든 슬레이브의 AL-STATE도 마스터의 AL-STATE와 같은 값으로 바꿔줍니다.ecNet_SetAlState함수는 마스터 보드의 AlState를 설정 합니다.


PARAMETER
`````````````

- NetID : 사용자가 사용 할 Network 번호

- :ref:`AlState  <ecat_enum_EEcAlState>`  : ecNet_SetAlState(), ecNet_SetAlState_FF() 함수의 인자이며, AlState 값입니다.

- ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.




RETURN VALUE
`````````````

- ComiECAT SDK라이브러리에서 발생시킨 명령들의 일련 번호인 CmdIdx를 반환합니다. 단, 이 값이 0이면 함수의 수행이 실패했음을 의미합니다.


.. seealso:: :ref:`ecNet_GetAlState`